home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u321.dms / in.adf / NGI.Doc < prev    next >
Encoding:
Text File  |  1993-11-08  |  6.7 KB  |  153 lines
  1. /****************************************************************/
  2.  
  3.     NGI - NewGetImage
  4.  
  5.     An IFF, ILBM & C Utility by
  6.         Kevin A. Bjorke
  7.         25724 Salceda Road
  8.         Valencia, CA 91355
  9.         CI$: 74756,464
  10.         PLink: ojs637
  11.  
  12. NGI is an Intuition-driven utility that will allow you to read, view, and
  13. reformat ILBM (DPaint, Aegis Images, etc) pictures. Although NGI was originally
  14. intended to simply be a replacement for the "gi" and "brush2c" utilities I
  15. had been using (that didn't always work, alas), I've found it to be very useful
  16. as an IFF viewer, too -- it loads faster and is MUCH smaller than DPaint, and
  17. can show several pictures during a single session -- so NGI is also an alter-
  18. native to programs like "ShowILBM" and "DPaintX." Even if you don't know
  19. what a BOB or IMAGE is, or don't write C code at all, NGI can still be a handy
  20. tool for your workbench.
  21.  
  22. /******* Instructions ********************************************/
  23.  
  24. When you start up NGI (from CLI or Workbench), you'll first get a title page.
  25. Hit the BEGIN gadget to go to the main workspace.
  26.  
  27. The main workspace has three NGI string gadgets and six button gadgets:
  28.  
  29. BRUSH: Enter the name of the brush you want to read. NGI will actually read any
  30.     IFF file that it can cram into memory, so the "brush" may be a full-
  31.     sized picture, even in hi-res.
  32.  
  33. OUTPUT: If you use NGI to generate new C files, enter the filename here.
  34.  
  35. STRUCT: If you use NGI to create C code, enter the name of the Image/Bob/Sprite
  36.     structure you want.
  37.  
  38. READ: Hitting READ will cause NGI to read the file named in the BRUSH string.
  39.     If the READ is successful, NGI will activate the SHOW, IMAGE, BOB,
  40.     and (if the size is right) SPRITE buttons. Those buttons are normally
  41.     "dead" until you READ at least SOME brush.
  42.  
  43. SHOW: If you've READ a BRUSH, you can display it on your Amiga screen, using
  44.     the original colors. Just hit SHOW. NGI will create a new display
  45.     screen for the picture. To exit the display and get back to NGI's
  46.     main workspace, just hit the close gadget on the display screen.
  47.     (Note: If you load a full-screen image with NGI, the close gadget will
  48.     get drawn-over. Don't worry, it's still there.)
  49.  
  50. HELP: Hitting HELP will give you a quick list of your options. Hit the OK
  51.     button on the HELP page to get back to the main workspace.
  52.  
  53. IMAGE: Hitting IMAGE will cause NGI to write a file with the OUTPUT name that
  54.     contains ImageData, a colortable, and Image structure, and a boolean
  55.     (button) gadget, all using the name you specified in STRUCT. All of the
  56.     buttons and pictures NGI usues were made by NGI itself in exectly this
  57.     way.
  58.  
  59. BOB: Hitting BOB will cause NGI to write a file with the OUTPUT name that
  60.     contains ImageData, CollMask, Save area, VSprite & Bob structures
  61.     all using the name you specified in STRUCT.
  62.  
  63. SPRITE: SPRITE will only be active if your READ brush was very small -- less
  64.     than 17 pixels wide. If it is, hitting SPRITE will cause NGI to write
  65.     an OUTPUT file that contains ImageData, Colors, and a VSprite usings
  66.     your STRUCT name.
  67.  
  68. Quitting NGI: Just hit the close gadget on the main NGI window (this is the
  69.     window that appears on the workbench, not the display screen).
  70.  
  71. /******* The Future ***********************************************/
  72.  
  73. Future Enhancements to NGI (see below):
  74.     
  75. 1. Easier file specification that using the string gadget to type something like
  76.     "pictures12:brush/wb-brushes/NewCLick.Brush" -- probably some sort of
  77.     file requester a la DPaint.
  78.  
  79. 2. Icons -- NGI could write icons from ILBM files, too. The only reason it
  80.     doesn't it that I couldn't decide where to put the button.
  81.  
  82. 3. More control over the C output. Right now, NGI often writes TOO MUCH code --
  83.     you may want an Image structure, but not the Boolean Gadget or the
  84.     color info. I did this because it's always easier to delete stuff than
  85.     it is to type it in. Slice out what you don't want. Future versions
  86.     of NGI will probably have toggles you can call from a menu, to set
  87.     flags for that sort of thing.
  88.  
  89. 4. Multiple images. If NGI could read multiple brushes (not a hard thing to
  90.     do), it could create GADGHIMAGE button gadgets, special knobs for
  91.     Proportional gadgets, and even set up multi-Bob AnimComps. Since 
  92.     animation development is what I built NGI for in the first place, this
  93.     is a high priority. I HATE doing repetitive stuff.
  94.  
  95. 5. Mask/Stencil Planes. Since Image structures don't use Mask planes, NGI
  96.     doesn't bother with them. They can sometimes be handy for animation,
  97.     however.
  98.  
  99. 6. Basic? NGI could also write BASIC "objects," if we ever got requests for
  100.     that sort of thing.
  101.  
  102. 7. More reso control. It would sometimes be nice to see what small brushes look
  103.     like at higher resos, especially when their ultimate destination is the
  104.     Workbench screen.
  105.  
  106. 8. Special CLI options in addition to the mouse. It might be nice to make a
  107.     BOB with a line like "NGI -b df1:brush/dude2 sys:dude2.s BowLeg2" i.e.
  108.     "NGI <option(s)> <brush> <output> <struct>" I like mouse-driven code,
  109.     but the simplest way is always the best -- always the tricky part of
  110.     providing programs that are flexible.
  111.  
  112. /******* Misc Technical Info ************************************/
  113.  
  114. NGI was written in C, using the Lattice compiler under WorkBench 1.2.
  115. Most of its size (about 27K) is actually just the various structures
  116. and ImageData blocks, with the code being pretty short -- the IFF reader
  117. is probably more than half of the code. NGI used the Lattice "-a" option,
  118. so NGI should run properly on heavily-expanded machines, loading all ImageData
  119. into CHIP memory. Bon appetit bitblt.
  120.  
  121.                         - KAB May 1987
  122.  
  123. /******* National Pixel Products ********************************/
  124.  
  125. About National Pixel Products:
  126.     National Pixel Products was created in by ex-employees of the late,
  127. great Digital Productions/Robert Abel & Associates/Omnibus Computer Graphics;
  128. makers of supercomputer graphics for the entertainment industry. While the
  129. Amiga is no Cray, we all think it's the hottest box on the block, even AFTER
  130. the Mac-2. Accept no substitutes.
  131.     Future projects include a high-quality scan-line renderer (MUCH faster
  132. than ray-tracing) and other multi-purpose graphics tools like NGI -- we are
  133. also working on the adaptation of a Hugo Award-winning novel as an Amiga game.
  134.  
  135. (Deluxe Paint and Deluxe Paint 2 are trademarks of Electronic Arts.
  136. Aegis and Aegis Images are trademarks of Aegis Development. Amiga and
  137. Workbench are trademarks of Commodore Business Machines. Lattice is a
  138. trademark of Lattice, Inc.)
  139.  
  140. /******** NGI Updates and Source Code ***********************************/
  141.  
  142. For updates, and complete source of NGI with examples of use (and to be on
  143.     our mailing list, of course), send $25 to:
  144.  
  145. Kevin A. Bjorke
  146. National Pixel Products
  147. 25724 Salceda Road
  148. Valencia, California 91355
  149.  
  150. We'd of course like to hear your comments and wishes, too.
  151.  
  152. /****************************************************************/
  153.